Release 10.1A: OpenEdge Application Server:
Administration

Summary of management tasks

This section summarize the basic management tasks that are available to maintain existing AppServer configurations. They are described with reference to the command-line utilities, but you can also accomplish most of these tasks, except running the AdminServer, using the Progress Explorer.

Table 2–4 describes the utilities (in addition to the Progress Explorer tool) that OpenEdge provides to help configure and manage an AppServer installation, listed generally in order by task.

Table 2–4: AppServer utilities 

Utility	Execution location	Description
ASBMAN	Local or remote to the AppServer installation.	Starts, stops, adds AppServer agents, trims AppServer agents, and queries status for an AppServer instance and its AppServer agent.
ASCONFIG	Local to the AppServer installation files.	Validates the syntax of AppServer configurations in the ubroker.properties file. (Never needed if you always use the Progress Explorer GUI.)
NSCONFIG	Local to the AppServer installation files.	Validates the syntax of NameServer configurations in the ubroker.properties file. (Never needed if you always use the Progress Explorer GUI.)
NSMAN	Local or remote to the NameServer machine.	Starts, stops, and queries status for a NameServer.
PROADSV	Local to the AppServer installation.	Starts, stops, and queries status for the AdminServer on UNIX. In Windows, you start the AdminService as a Windows service using the Services applet in the Control Panel.

For more information on the NameServer and NSMAN utility, and the AdminServer and PROADSV utility, see the "NSMAN" section, the "PROADSV" section, OpenEdge Getting Started: Installation and Configuration .

Table 2–5 lists sample command-line utility syntax used to:

Start and stop the AdminServer on the Windows platform.
Start, query, and stop the AdminServer on the UNIX platform.
Verify the configuration of, start, query, and stop a NameServer instance.
Verify the configuration of, start, query, add AppServer agents to, trim AppServer agents from, and stop an AppServer instance.

Table 2–5: Management tasks

To do this task ...	Use these steps or commands ...
Start or stop the AdminService in Windows.	From the Windows Control Panel, choose Administrative Tools, then choose Services. Choose the AdminService for OpenEdge, and click either Start, Restart, or Stop.
Start the AdminServer on UNIX.	proadsv -start
Start the AdminServer on UNIX using a specified port.	proadsv -port port-number -start
Query the AdminServer on UNIX.	proadsv -host host-name -user user-name -query
Stop the AdminServer on UNIX.	proadsv -stop -port port-number
View a NameServer configuration in the ubroker.properties file.	nsconfig -name Name-Server
Validate the syntax and view the configurations of all NameServer instances defined within a specified property file.	nsconfig -propfile property-file-path -validate
Start a local NameServer.	nsman -name Name-Server -start
Start a remote NameServer.1, 2	nsman -name Name-Server -host host-name    -port port-number -user user-name -start
Query a local NameServer.	nsman -name Name-Server -query
Query a remote NameServer.1	nsman -name Name-Server -host host-name    -port port-number -user user-name -query
Stop a local NameServer.	nsman -name Name-Server -stop
Stop a remote NameServer.1	nsman -name Name-Server -host host-name    -port port-number -user user-name -stop
View an AppServer configuration in the ubroker.properties file.	asconfig -name AppServer-name
Validate the syntax and view the configurations of all AppServer instances defined within a specified property file.	asconfig -propfile property-file-path -validate
Start a local AppServer.	asbman -name AppServer-name -start
Start a remote AppServer.1	asbman -name AppServer-name -host host-name    -port port-number -user user-name -start
Query a local AppServer.	asbman -name AppServer-name -query
Query a remote AppServer.1	asbman -name AppServer-name -host host-name    -user user-name -query
Add AppServer agents to a local AppServer.	asbman -name AppServer-name -addservers #
Add AppServer agents to a remote AppServer.1	asbman -name AppServer-name -host host-name    -user -addservers #
Trim AppServer agents from a local AppServer.	asbman -name AppServer-name -trimservers #
Trim AppServer agents from a remote AppServer.1	asbman -name AppServer-name -host host-name    -user user-name -trimservers #
Stop a local AppServer.	asbman -name AppServer-name -stop
Stop a remote AppServer.1	asbman -name AppServer-name -host host-name    -port port-number -user user-name -stop

1Prompts for a password. 2This is a NameServer defined on a remote machine, not a remote NameServer instance defined in the ubroker.properties file of the local machine.